home *** CD-ROM | disk | FTP | other *** search
/ Amiga Mag HDD Backup / Amiga Mag HDD Backup.zip / Amiga Mag HDD Backup / Alexander.img.bin / Alexander.img / tech 4.1 editorial Archive.sit / Steichen / PasteUp.help < prev    next >
Text File  |  1993-07-26  |  9KB  |  239 lines
  1.                  General PasteUp⌐áInformation
  2.  
  3. PasteUp⌐ is a collection of file manipulation utilities that are
  4. useful for cutting & pasting lines of text, removing & replacing
  5. a word that occurs throughout a file, or getting information
  6. about a file's contents.  PasteUp⌐ also has an ARexx⌐ interface
  7. that allows the user to use PasteUp⌐ in ARexx⌐ programs.  PasteUp⌐
  8. will not allow you to over-write an existing file or leave without
  9. giving you a chance to save your work.  This is NOT true however,
  10. for those that use PasteUp⌐ from ARexx⌐ programs!  PasteUp⌐ was
  11. written & tested by Jim Steichen using CanDo⌐ V2.01.  I wrote
  12. PasteUp⌐ because the commands it contains are some that I use freq-
  13. uently in writing new programs from old fragments.  The commands
  14. were written in C & are only available from the CLI or other shell.
  15. This Graphical-User-Interface makes them much easier to use!
  16.  
  17.  
  18.                        File_Information
  19.  
  20. The Information window allows the user to obtain two basic kinds of
  21. information about a file:
  22.    1. Findword:  returns the line numbers & the lines that contain
  23.                  the word entered into the 'Word:' gadget in the
  24.                  window.
  25.  
  26.    2. Fileinfo:  returns the number of lines, words, characters &
  27.                  pages contained in a text file.
  28.  
  29.  
  30.                         Goto_Alterations
  31.  
  32. This button will change the window of PasteUp⌐ to the Alterations window.
  33.  
  34.  
  35.                        Information_Menus
  36.  
  37. There are two menu selections available to the user in the Infor-
  38. mation window:
  39.    1. Save Results (A-S)  Saves the contents of the 'Command Results'
  40.                           list gadget in a filename that the user
  41.                           supplies.
  42.  
  43.    2. Quit!        (A-Q)  Exits PasteUp⌐.
  44.  
  45.  
  46.                         File_Alteration
  47.  
  48. NOTE:  The user can edit the 'Command Results' list gadget contents before
  49.        saving them to the out file name.
  50.         
  51. The Alteration window allows the user to:
  52.  
  53.    1. remove   StartLine_# EndLine_# InputFile
  54.          Removes entire lines from the InputFile Starting at
  55.          StartLine_# & stopping at EndLine_#.
  56.  
  57.    2. extract  StartLine_# EndLine_# InputFile
  58.          Gets entire lines from the InputFile Starting at StartLine_#
  59.          & stopping at EndLine_#.
  60.  
  61.    3. insert   StartLine_# InsertFile DestinationFile
  62.          Inserts the contents of InsertFile into DestinationFile
  63.          beginning at StartLine_# of the DestinationFile.
  64.  
  65.    4. delete   DeleteWord InputFile
  66.          Deletes every occurance of 'DeleteWord' in the InputFile.
  67.             
  68.    5. replace  DeleteWord ReplaceWord InputFile
  69.          Deletes every occurance of 'DeleteWord' in the InputFile &
  70.          replaces them with 'ReplaceWord'.
  71.  
  72.  
  73.                            Get_Info
  74.  
  75. This button will change the PasteUp⌐ window to the Information window.
  76.  
  77.  
  78.                         Alteration_Menu
  79.  
  80. There is only a 'Quit!' (A-Q) menu selection available in the Alter-
  81. ation window.  It allows the user to exit PasteUp⌐ from the Alter-
  82. ation window.
  83.  
  84.  
  85.                          PasteUp_Help
  86.  
  87. There is no manual for PasteUp⌐, since the entire program is described
  88. in the on-line help window.  Feel free to print out PasteUp.help if
  89. you need to refer to it often.  This shouldn't be necessary since
  90. the things that PasteUp⌐ does are fairly straightforward.  Click on
  91. a word in 'Help Index' or type it into the 'Search For:' gadget in
  92. order to see the help entry about the word in 'Help Information'.
  93.  
  94.  
  95.                             ARexx
  96.  
  97. PasteUp⌐ has an ARexx⌐ interface that does everything that the user
  98. can do with PasteUp⌐ albeit in a slightly different fashion.  After
  99. all, if the user doesn't want to sit & assist the computer in
  100. operating PasteUp⌐, then PasteUp⌐ has to run in an entirely auto-
  101. mated fashion!  See TestPasteUp.rexx for a good example on how to use
  102. all the available ARexx⌐ácommands inside PasteUp⌐.  The following
  103. commands for PasteUp⌐ are available to ARexx⌐ programs:
  104.  
  105.    NoDisplay    This command simply pushes the PasteUp⌐ screen to the
  106.                 back of all other open screens.
  107.  
  108.    Quit         This command shuts down PasteUp⌐ completely.
  109.  
  110.    GotoInformation  This command changes the PasteUp⌐ display to the
  111.                     Information window.
  112.  
  113.    GotoAlteration   This command changes the PasteUp⌐ display to the
  114.                     Alteration window.
  115.  
  116.  
  117.                          FindWord_ARexx
  118.  
  119.    findword word filename  This command finds all occurances of 'word'
  120.                            in filename & saves them in a file called
  121.                            FindWord.txt in the following format:
  122.  
  123.             Line#: Text line of inputfile that contains 'word'.
  124.  
  125.  
  126.                          FileInfo_ARexx
  127.  
  128.    fileinfo filename [page_size]  This command returns an information
  129.                                   string about the filename in the
  130.                                   following format:
  131.  
  132.             # lines: xx, # words: xx, # char's: xx, # pages: xx
  133.  
  134.       NOTE:  The number of pages depends on the page_size number you
  135.              supply.  This number has to be greater than 0
  136.              (Default: 66).
  137.  
  138.  
  139.                           Remove_ARexx
  140.  
  141.    remove Start_# End_# InputFile OutputFile  This command removes
  142.                                               entire lines from the
  143.       InputFile starting at Start_# & ending at End_#.  The result is
  144.       written into OutputFile.
  145.  
  146.  
  147.                           Extract_ARexx
  148.  
  149.    extract Start_# End_# InputFile OutputFile  This command extracts
  150.                                                entire lines from the
  151.       InputFile & writes them to OutputFile.  InputFile remains
  152.       unaltered.
  153.  
  154.  
  155.                            Insert_ARexx
  156.  
  157.    insert  Start_# InsertFile DestinationFile OutputFile  This
  158.                                                           command
  159.       inserts the InsertFile after the line Start_# in the
  160.       DestinationFile.  The result is written to OutputFile.
  161.  
  162.  
  163.                            Delete_ARexx
  164.  
  165.    delete  word InputFile OutputFile  This command deletes all occur-
  166.                                       ances of 'word' in the InputFile
  167.       & writes the remainder to the OutputFile.
  168.  
  169.  
  170.                           Replace_ARexx
  171.  
  172.    replace old_word new_word InputFile OutputFile  This command removes
  173.                                                    all occurances of
  174.       'old_word' from the InputFile & replaces them with 'new_word'.
  175.       The results are written to OutputFile.
  176.  
  177.                           
  178. FindWord - In order to use this button, the user supplies a word to
  179.            search for & a filename to search in.  It finds all
  180.            occurances of the search word in filename & shows them in
  181.            'Command Results' in the following format:
  182.  
  183.            Line#: Text line of inputfile that contains 'word'.
  184.  
  185.  
  186. FileInfo - In order to use this button, the user supplies a filename &
  187.            optionally supplies a number in 'PageLen' (> 0!).  A string
  188.            about the filename is written to 'Command Results' in the
  189.            following format:
  190.  
  191.            # lines: xx, # words: xx, # char's: xx, # pages: xx
  192.  
  193.     NOTE:  The number of pages depends on the PageLen number you
  194.            supply.  This number has to be greater than 0
  195.            (Default: 66).
  196.  
  197.  
  198. Remove - In order to use this button, the user must supply a starting
  199.          line #, an ending line # & an Input File name.  Once the
  200.          button is released, entire lines are deleted from the
  201.          InputFile starting at Start_# & ending at End_#.
  202.  
  203.          NOTE:  Simply click on the desired starting line in the
  204.                 'Source Text' list & the starting line # will be
  205.                 written into 'Start #:'; clicking again will write
  206.                 the ending line # into 'End #:'.  Make sure that
  207.                 the ending line # is greater than the starting line #!
  208.  
  209.  
  210. Extract - In order to use this button, the user must supply a starting
  211.           line #, an ending line # & an Input File name.  Once the
  212.           button is released, entire lines are copied to 'Command Results'
  213.           from the 'Source Text', starting at Start_# & ending at End_#.
  214.           The 'Source Text' will be unaltered after the operation.
  215.  
  216.           NOTE:  Simply click on the desired starting line in the
  217.                  'Source Text' list & the starting line # will be
  218.                  written into 'Start #:'; clicking again will write
  219.                  the ending line # into 'End #:'.  Make sure that
  220.                  the ending line # is greater than the starting line #!
  221.  
  222.  
  223. Insert - In order to use this button, the user must supply a starting
  224.          number in 'Start #:' & a Destination filename in 'Input File:'.
  225.          PasteUp⌐ will query the user for the insert filename that it
  226.          needs to perform the command.
  227.  
  228.  
  229. Delete - In order to use this button, the user must supply a word to
  230.          delete (in 'Old Text') & a filename to delete them from.
  231.          Delete will remove all occurances of the word in the file &
  232.          place the results in 'Command Results'.
  233.  
  234.  
  235. Replace - In order to use this button, the user must supply a word to
  236.           delete (in 'Old Text'), a word to insert (in 'New Text') & a
  237.           filename.  PasteUp⌐ replaces all occurances of
  238.           'Old Text' from the file & replaces them with 'New Text'.
  239.